home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / transbbs.lzh / TRANSBBS.DOC < prev    next >
Encoding:
Text File  |  1992-07-17  |  42.1 KB  |  1,057 lines

  1.  
  2.  
  3.  
  4.  
  5.                                 Transcendence BBS
  6.                                 (c) Copyright 1992
  7.                               Twilight Zone Software
  8.  
  9.                                   Programming by
  10.                             David Brown & Wayne Watson
  11.  
  12.                                All rights reserved
  13.  
  14.  
  15.         DOCUMENTATION NOTICE
  16.  
  17.              At this time the documentation is not complete.  If you have
  18.         purchased Transcendence, the documentation will be mailed to you
  19.         at no further charge, when completed.  This file is quite verbose,
  20.         so expect to have some unanswered questions.  For your
  21.         convenience, there are four support boards and a voice number,
  22.         incase you have some questions.  You may also mail questions to
  23.         Twilight Zone Software.
  24.  
  25.         Twilight Zone Software
  26.         P.O. Box 7264
  27.         Louisville, KY  40257
  28.  
  29.         (502) 897-1582 (Voice support, David Brown: EST noon-9:00pm)
  30.         (502) 897-1589 (Data, HST 9600)
  31.         (803) 879-4186 (Data, v.32bis 9600)
  32.         (502) 245-0386 (Data, v.32 9600)
  33.  
  34.  
  35.         COPYRIGHT NOTICES
  36.  
  37.              The Transcendence BBS program (TRANSBBS.PRG, KEYCODE.DAT),
  38.         and this manual are copyrighted by Twilight Zone Software.
  39.         Unauthorized reproductions of those files, or the manual is
  40.         strictly prohibited by international copyright laws.  This
  41.         software is not allowed to be "rented" or "borrowed", such acts
  42.         are clearly a violation of copyright laws.  We reserve the right
  43.         to deny updates & support to anyone, for disobeying the copyright.
  44.              We have always provided you with a non-copyprotected BBS
  45.         package, with the hopes that you will not distribute it without
  46.         our written permission.  "Pirating" software, as illegal copying
  47.         is often called, only hurts the authors of the program, and those
  48.         who paid for the program.  Please do your part and do not support
  49.         software piracy.
  50.  
  51.  
  52.         BE WARNED!
  53.  
  54.              In development of the Transcendence BBS package, we have
  55.         attempted to create a bug-free system, with no harmful side
  56.         affects.  Unfortunately, with a program of this size, it is
  57.         impossible for us to predict every configuration a sysop could
  58.         create.  Due to this we must ask you to use the software with your
  59.         own risk.  We can not be held reasonable for damage (Or loss) of
  60.         data, hardware or software.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.         CREDITS
  72.  
  73.              In the development of this BBS system we have had help from
  74.         many, many people.  For those of you who are not mentioned, I
  75.         offer my apologies.
  76.              We thank Greg Xynides for the endless hours he spent beta
  77.         testing early versions of the BBS.  Even today he still sends us
  78.         full reports on anything we have forgotten, or messed up.
  79.              Jeff White wrote the 68000 code we use for CRC-16 testing.
  80.         This code has proven to be fast, effective, and bug-free.
  81.              We also would like to thank everyone who has offered ideas,
  82.         suggestions, and who has taken the time to let us know what we were
  83.         doing wrong.  There are too many of you to name here, but you know
  84.         who you are.
  85.  
  86.  
  87.         TRANSCENDENCE HISTORY
  88.  
  89.              The Transcendence BBS package was original conceived by David
  90.         Brown in 1986.  He began researching BBS programs, how they work,
  91.         and how they don't work.  At this time he did not know the first
  92.         thing about computer programming (His first computer was a 520ST,
  93.         in Oct. 1985).  He began teaching himself how to write this type
  94.         of software by programming online door software.
  95.              In mid 1987 he began work on the "STark" BBS program.  Soon
  96.         he was joined by Jason Dickens.  They worked on the program for
  97.         about 2 years, and due to legal complications had to terminate
  98.         their joint-effort.  For a one year period David was without the
  99.         source code to the STark BBS program.  Since BBS programming was
  100.         his work away from work, he started a new one.  This program was
  101.         entitled "STairway" (It was never completed).  He then obtained
  102.         the source code to STark, and used the two programs to create what
  103.         is now "Transcendence."  Soon after starting on Transcendence
  104.         started, Wayne Watson began re-writing many of the old STark
  105.         routines.
  106.              Since Wayne & David started working together, they have never
  107.         stopped to take a breath.  The program has gone through massive
  108.         rewrites and modifications.  The current program we have is beyond
  109.         what we ever thought we could do.  We feel that we have succeeded
  110.         in creating the most flexible, powerful, user-friendly, and sysop-
  111.         friendly BBS system ever.  Our sysops seem to agree.
  112.  
  113.  
  114.         TRANSCENDENCE SUPPORT
  115.  
  116.              One of the main benefits to the Transcendence BBS system is
  117.         our support.  All updates to our software are 100% free.  You pay
  118.         only the phone bill, or postage.  We are planning a moduler
  119.         version of the BBS system, there will be a minimal update fee for
  120.         this, but it will be a one time fee.
  121.              We rely on our sysops to give us feedback on the program.
  122.         Ninety percent of the features in the software are features
  123.         requested by one of our sysops.  Unlike other software, we
  124.         actually listen to our clients.
  125.              You can obtain your free updates by calling one of our
  126.         support BBSs, or by mailing a Self-Addressed-Stamped-Envelope,
  127.         with a disk enclosed, to our post office box.
  128.              We encourage you to give us suggestions.  We can only improve
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.         the program if you let us know how.  We also need to know if
  138.         something is not working correctly.  If you find any "bugs" in the
  139.         software, let us know.  We can't fix 'em, if we can't find 'em!
  140.  
  141.         Twilight Zone Software
  142.         P.O. Box 7264
  143.         Louisville, KY 40257
  144.  
  145.         (502) 897-1582 (Voice - 11:00am - 10:00pm Monday thru Friday EST)
  146.         (502) 897-1589 (Support Line One: 14.4k Supra v.32bis)
  147.         (804) 879-4186 (Support Line Two: 14.4k Supra v.32bis)
  148.  
  149.  
  150.                            CHAPTER ONE: Getting Started
  151.  
  152.         SYSTEM REQUIREMENTS
  153.  
  154.              To run the Transcendence BBS System you need the following
  155.         hardware:
  156.  
  157.              o 520, 1040, Mega ST, STe, or TT
  158.              o At least 1 meg of RAM
  159.              o A modem (Hayes Compt. preferably)
  160.              o A hard drive with at least 20 megs of space
  161.              o Color or MONOchrome monitor (Medium & high resolution only)
  162.  
  163.              The following software/hardware is preferable, but not
  164.         required:
  165.  
  166.              o Printer
  167.              o XYZ external Zmodem protocol
  168.              o Software or hardware backup utility
  169.              o Micro Emacs Editor (Remote version)
  170.  
  171.  
  172.         PREPARING TO CREATE YOUR BBS SYSTEM
  173.  
  174.              There are many things to consider before you begin the
  175.         installation process.  Many new sysops overlook these details,
  176.         we hope we can prevent you some heartache down the road.
  177.              The Transcendence BBS System takes up a lot of Hard Drive
  178.         Space.  Before installing the BBS you must make sure you have
  179.         enough hard drive space.  To do this, delete old files you do not
  180.         need, copy files you do not use often to floppy.
  181.              If you were to create a BBS allocated for 100 users and five
  182.         message bases (100 messages each, 20 lines long), that would take
  183.         about 2-3 megs of hard drive space.  Hopefully that will give you
  184.         some idea of how much room you will need.
  185.               You can tell the BBS System what partitions to use for each
  186.         type of data it creates/uses.  For example, you can have your
  187.         download files on drive C & D, your message base files could be on
  188.         drive F, and all other files on drive H.  While you clear off your
  189.         hard drive space take into consideration where you want your
  190.         different types of data.  You can use the same partitions for all
  191.         of the data files the BBS uses, or use many different ones, it all
  192.         depends on what you want.
  193.              Transcendence uses "Pre-Allocated" data storage.  That is,
  194.         whenever possible the BBS makes all data files to their full size.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.         This makes file access faster, and reduces the chance of DISK FULL
  204.         errors (No BBS can prevent DISK FULL errors, only the Sysop can!).
  205.         Whenever Transcendence has to create a file, it picks the drive
  206.         with the most space (assuming you have it set up to use more than
  207.         one drive).
  208.              The next big step is to think about how you want your BBS to
  209.         be setup.  Decide on what types of message bases you want, and
  210.         what types of file areas you want.  We suggest writing this
  211.         information down, you will need it soon.
  212.              Now make sure you have enough disk space, and have prepared a
  213.         list of message bases & file areas, and lets get started creating
  214.         your BBS!
  215.  
  216.  
  217.         THE MASTER DISK
  218.  
  219.              Within this documentation you should have received a disk.
  220.         The disk is in DS/DD format.  If you can not read that type of
  221.         disk, contact Twilight Zone Software to get a replacement.
  222.              Before doing anything else, make a backup copy of your master
  223.         disk.  Use the backup when possible, store the original for
  224.         safekeeping.  If you have trouble creating a backup copy of your
  225.         original disk consult your Atari owners manual for "Duplicating"
  226.         disks.
  227.  
  228.  
  229.         YOUR KEYCODE.DAT FILE
  230.  
  231.              The file called KEYCODE.DAT is a private-key type of file.
  232.         In this file is your name, and serial number.  This file is not to
  233.         be given out to anyone, for any purpose.  If someone gets a copy
  234.         of your KEYCODE.DAT file please contact Twilight Zone Software for
  235.         a replacement copy.  (We can prevent 'stolen' KEYCODE.DAT files
  236.         from working.)
  237.  
  238.                           CHAPTER TWO: Creating your BBS
  239.  
  240.  
  241.         INTRODUCTION TO THIS CHAPTER
  242.  
  243.              In this chapter we are going to explain how to install a
  244.         complete bulletin board system.  After reading this you should
  245.         feel comfortable with your own BBS installation.
  246.              Please remember that the Transcendence Bulletin board System
  247.         is loaded with options, and the way we are setting up this
  248.         bulletin board may be different from the way you want to set up
  249.         your own bulletin board.  We have attempted to explain all of the
  250.         options in great detail.
  251.  
  252.  
  253.         OUR BBS DESIGN
  254.  
  255.              As described in the previous chapter, we have made a list of
  256.         message bases we want, file areas, etc.  The following is a list
  257.         of things you might want to consider before you install your own
  258.         bulletin board.  Please remember, this is only an example, you can
  259.         make your BBS anyway you want!
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.         (Enclose the following in a box):
  270.  
  271.         Message bases:
  272.              General BBS chatter : 100 Msgs max., 20 lines each.
  273.              Atari ST            : 100 Msgs max., 15 lines each.
  274.              Local Atari club    : 250 Msgs max., 15 lines each.
  275.              Endless story       : 500 Msgs max., 20 lines each.
  276.              "Anonymous" msgs    : 50 Msgs max., 20 lines each.
  277.              Computer wars       : 100 Msgs max., 10 lines each.
  278.              High Access Users   : 50 Msgs max., 10 lines each.
  279.  
  280.         File areas:
  281.              Atari ST games      : 5 line descriptions
  282.              Atari ST utilities  : 10 line descriptions
  283.              Atari ST misc.      : 5 line descriptions
  284.              Text files          : 5 line descriptions
  285.              Pictures/ART        : 5 line descriptions
  286.              Sysops only         : 5 line descriptions
  287.  
  288.         Data storage:
  289.              DATA files          : Drives C,D
  290.              MESSAGE files       : Drive E
  291.              TEXT files          : Drive E
  292.              FILE area files     : Drives C,D,E
  293.              FMAIL files         : Drives D,E
  294.              BACKUP files        : Drive F
  295.              MODULES files       : Drive F
  296.              TEMP files          : Drive C
  297.         Main BBS partition: C.  Main BBS folder name: TRANS
  298.  
  299.         (End of setup box)
  300.  
  301.              You can have up to 256 message bases, and 256 file areas.
  302.         The BBS program will also access all of your hard drive
  303.         partitions (Or only a certain number of them).
  304.              We suggest you make a similar list, with the message bases
  305.         you want, file areas, and where you want your different types of
  306.         data.  The 'main BBS partition' is the drive you will be running
  307.         your BBS from.
  308.              Transcendence creates all of its data inside of folders.  We
  309.         suggest you use "TRANS" for your main folder.  If you do use
  310.         "TRANS" then you will have a folder named "TRANS" on each
  311.         partition you define for the BBS to use.  Inside of that folder
  312.         will be more folders for the various types of data.  If you prefer
  313.         you can not have a MAIN folder, in that case all of your other
  314.         folders would be in the root directory.  We prefer using a main
  315.         folder since it does not clutter your partitions with lots of
  316.         folders in the root directories.
  317.  
  318.  
  319.         BEGINNING THE INSTALLATION
  320.  
  321.              Place the backup of your master disk into drive A (You better
  322.         had made a backup!).  By now you should have decided on your main
  323.         partition, and main BBS folder name.  If you are going to use
  324.         "TRANS" as your main folder name simply copy the entire "TRANS"
  325.         folder from your master disk, to the root directory of the
  326.         partition you will be running the BBS from.  The will copy the
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.         folder, and all of the files as well.  If you prefer to use a
  336.         different main BBS folder name then CREATE a folder with that name
  337.         on your main BBS partition.  Open the "TRANS" folder on your
  338.         master disk and copy all of the files into your main BBS folder.
  339.              In our example we simply copied the "TRANS" folder onto drive
  340.         (partition) C.
  341.              Now open the main BBS folder (If it isn't already).  You
  342.         should see quite a few filenames.  The only one to worry about now
  343.         is the "SYSEDITG.PRG".  This is the System Editor.  It will create
  344.         almost all of the data you need to run your BBS system.  Execute
  345.         this program by double-clicking on its icon, or filename.
  346.              You will be presented with an information box (fig. 1), press
  347.         [Return] and the system editor will load some data, and then
  348.         present you with a file-selector box.  The system editor is
  349.         looking for the "TRANS.DAT" file, which you have not yet created.
  350.         Since you do not have one, select [Cancel].  Now you will see an
  351.         alert box asking you if you would like to create a new BBS (fig.
  352.         2).  Select "YES".
  353.  
  354.         --------
  355.  
  356.              The System editor will have a lot of questions dealing with
  357.         the configuration of your BBS.  Refer to the SYSEDITG.TXT file for
  358.         further information.
  359.              Be sure to copy the default data files (included on your
  360.         master disk) to their proper folders.  This is the most common
  361.         mistake made, so be sure to copy them:
  362.  
  363.         PROMPT.DAT - into your MENUS0 folder (Inside the TEXT folder)
  364.         COMMAND.DAT, MASKS.DAT, PROTOCOL.DAT - into your DATA folder
  365.  
  366.         BE SURE to copy all of the files in the MENUS0 folder (On your
  367.         master disk) into the MENUS0 folder on your hard drive.
  368.  
  369.              You should now be able to run the TRANSBBS.PRG file.  After
  370.         doing so, the BBS will go into a logon immediately.  At that time
  371.         fill in your own information.  After the logon is complete, you
  372.         may want to edit your own information, to increase your access.
  373.         To do this, press Function key #3.  Select "ONLINE USER", and
  374.         begin editing.  Be sure to WRITE TO DISK when your done.
  375.  
  376.         OTHER INFORMATION
  377.  
  378.  
  379.         The New Menu Processor:
  380.         [=====================]
  381.  
  382.                 The new version of Transcendence now has new text handling 
  383.         routines, and a new menu processor.  This new menu processor should
  384.         fix any problems you have had with menus inside of menus, and has
  385.         many new options.
  386.  
  387.                 This new menu processor is quite similar to the old one, and 
  388.         should work with modifying your old menu files.  But there are many 
  389.         changes, so be sure to read all of this file.
  390.  
  391.                 For those of you who are new to "menu processing", it is a simple
  392.         way of creating easy to use "Menus" for the user to make selections 
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.         from.  The menus are ASCII files that you create.  A menu could 
  402.         contain several text files for the user to view.  They may contain 
  403.         online games for the user to play.  The options are quite endless, as 
  404.         you will see.
  405.  
  406.                 As before the first three lines of a menu describe how it should 
  407.         work.  The first line is the "options" line.  It describes if it is a 
  408.         menu, if the user can ABORT it, what level you need to access it, and 
  409.         many other things.  The second line is your "prompt" line.  It is the 
  410.         prompt that the user will see after the menu is displayed.  The third 
  411.         line is the number of selections in that menu.
  412.  
  413.                 After the first three lines is your "selections list."  This list 
  414.         is as long as you specified in line #3.  After the list is complete 
  415.         you will put the actual menu that the user sees.
  416.  
  417.                 If your new at this, your probably lost right now.  Hang in 
  418.         there, you'll get it...
  419.  
  420.         The "options" line (Line #1)
  421.         [--------------------------]
  422.  
  423.                 The options line must start with "MENU" or "TEXT".  ("TEXT" menus 
  424.                 are explained later).  After that you can place any of these 
  425.                 modifiers in any order:
  426.  
  427.                 NOABORT         The menu can NOT be aborted with ^C if this modifier is 
  428.                                 used.
  429.                 NOPAUSE         The menu can not be paused with ^S.
  430.                 LEVEL_xx        The user must have a MENU level of at least "xx" to 
  431.                                 see/use the menu (xx can be any number from 0 to 255).
  432.                 AGE_xx          Simlilar to the previous, but it reflects the users
  433.                                 age.  If you use "AGE_18" the user would have to be 18
  434.                                 years old to see/use the menu.
  435.                 MONLY           Only MALE users can see/use the menu.
  436.                 FONLY           Only FEMALE users can see/use the menu.
  437.  
  438.         examples:
  439.  
  440.                 "MENU NOABORT LEVEL_100"        (Only Users with a menu level 
  441.                                                  of 100 could see this menu, and 
  442.                                                  they couldn't abort it.)
  443.                 "MENU AGE_18 NOPAUSE FONLY"     (Only users 18 years, or older, 
  444.                                                  and only female users.  The menu 
  445.                                                  also could not be paused with ^S.)
  446.         The selection line (Line #2)
  447.         [--------------------------]
  448.  
  449.                 The selection line is whatever you want it to be.  Usually it is 
  450.         just something simple like "Make your selection: ".
  451.  
  452.         The menu selections
  453.         [-----------------]
  454.  
  455.                 You may have up to 256 selections for each of your menus.  The 
  456.         number you are going to have should be in line #3.  The forth line 
  457.         begins your selections list.  This list will tell the BBS how to 
  458.         handle the menu.  You can have four types of selections from a menu.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.         The syntax for an selection looks like this:
  468.  
  469.         key type filename [Return? Y/N] Special
  470.         ^   ^    ^        ^             ^
  471.         |   |    |        |              \_____ This field changes for 
  472.         |   |    |        |                     different commands.
  473.         |   |    |        \____ Display a return prompt after the user makes 
  474.         |   |    |              his/her selection (Not usable with all types)
  475.         |   |    \____ The "filename" field is simply a filename to be used
  476.         |   \____ There are four different "Types" of selections a user can 
  477.         |         make, they are explained below.
  478.         \____ The "key" field is the key press (Or series of) the user has to 
  479.                   make to access that selection.
  480.  
  481.         The different "types":
  482.                 "P" (Or 'B'):   If this character is used in the TYPE field, then 
  483.                                 you are telling the menu to perform a command 
  484.                                 normally only performed from the command tables.  
  485.                                 With this you could have menu options to page the 
  486.                                 sysop, leave feedback, or just about anything.  
  487.                                 In the "Filename" field you place the filename of 
  488.                                 the command you want it to perform.  Refer to the 
  489.                                 command tables section of your documentation for 
  490.                                 a list of all the different ones.  The "RETURN" 
  491.                                 field can be a "Y" or a "N".  If it is a "Y" (The 
  492.                                 default) it will ask the user to press RETURN 
  493.                                 before going back to the menu.  The special field 
  494.                                 is not used.
  495.                 "C" (Or 'E,X'): This will make the menu run an external program 
  496.                                 (For example an split-screen chat program).  In 
  497.                                 the filename field you put the complete pathname 
  498.                                 of the file to run (If you do not include a path 
  499.                                 it will look in the modules folder), and the 
  500.                                 special field is the TTP line for that file.  The 
  501.                                 "return" field is used the same as in the above.
  502.                 "T" (Or "M"):   This will allow you to display text files (Or 
  503.                                 more menu files!) from within your menu.  In the 
  504.                                 filename field put the complete pathname of the 
  505.                                 text/menu file (If you do not include the path 
  506.                                 then it will look inside of your MENUSx folder).  
  507.                                 You can have menus inside of menus, but the limit 
  508.                                 is 25.  You will get an error message if you try 
  509.                                 to go over that limit.  The return is used the 
  510.                                 same as in the above example, and there is no 
  511.                                 "special" field.
  512.                 "O" (Or "G"):   This will allow you to run a online game from 
  513.                                 within your menu.  The "return" field is NOT used 
  514.                                 when you are using this selection.  The filename 
  515.                                 is the complete pathname of the online game (If 
  516.                                 you do not include the path it will look in your 
  517.                                 modules folder).  The "return" field is used to 
  518.                                 tell the MENU what type of online game it is.  
  519.                                 ("FOREM", "TURBO" etc.)  The "special" field is 
  520.                                 the TTP line for that online game.
  521.  
  522.         Other things to know about menus
  523.         [------------------------------]
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                 In order to get out of a menu you must have an exit command.  
  534.         Your exit command is part of your selections list.  When you make an 
  535.         exit command you only use the "Key" & "Type" fields.  For example the 
  536.         key field may be "Q" and the type field would be "exit".  You can 
  537.         also use "exitall", this variation will make it exit ALL the menus it 
  538.         is in (If you have menus inside of menus).
  539.  
  540.                 In all of the above examples all of the "key" fields have been one
  541.         character long.  You can have "key" fields longer than one character, 
  542.         except for one reserved work which is "DEFAULT".  If you have the 
  543.         word "DEFAULT" in your "Key" field that command will be executed if 
  544.         the users keypress did not match ANY of the other "key" fields.  A 
  545.         good example of this is using the key field as "DEFAULT" and the type 
  546.         field as "EXIT".  If the user makes a selection not listed it will exit 
  547.         the menu.
  548.  
  549.                 Also if you use the '@' character in the key field it is 
  550.         considered a "Return".  Since you can not put the return character in 
  551.         the key field, '@' is used.
  552.  
  553.         Now for some examples
  554.         [-------------------]
  555.  
  556.                 In the following example the menu has 5 selections, four of them 
  557.         are text files, the last is an exit command:
  558.  
  559.         MENU
  560.         Selections [Press return to exit]: 
  561.         5
  562.         A t C:\BBS\TEXT\LOVE.TXT
  563.         B t C:\BBS\TEXT\MONEY.TXT
  564.         C t C:\BBS\TEXT\CARS.TXT
  565.         D t C:\BBS\TEXT\BBS.TXT
  566.         DEFAULT EXIT
  567.         {1}Example Data Base
  568.  
  569.         [A] Meet the women of your dreams
  570.         [B] How to make $1,000,000.00 in just 2 weeks
  571.         [C] Best buys on cars in 1992
  572.         [D] National BBS Listing (Updated 1/20/1990)
  573.  
  574.  
  575.                 Thats all there is to it.  If the user selects A,B,C,D they will 
  576.         see the proper file.  Selecting anything else will exit the menu 
  577.         (Even just pressing return).  (Note: The first line only contained 
  578.         the word "MENU"--You do not have to use the modifiers if you do not 
  579.         need them for that menu).  (Also note: the "Return" field was not 
  580.         used in that example, not using it defaults to ON for each selection.)
  581.         -----------------------------------------------------------------------
  582.                 In this example the menu will give the user three different ways 
  583.         to page the sysop.
  584.  
  585.         MENU NOABORT LEVEL_50
  586.         Whats it gonna be (Q=Exit)? 
  587.         4
  588.         1 c C:\BBS\SPITSCRN.PRG N
  589.         2 c D:\BBS\CHITCHAT.PRG N
  590.         3 p PAGESYS N
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.         Q exit
  600.         {1}Chat modes:
  601.  
  602.         [1] Split Screen Chat (Vt52)
  603.         [2] Split Screen Chat (Vt100/ANSI)
  604.         [3] Normal Chat
  605.         [Q] Exit Menu
  606.  
  607.                 In the above example the user can not abort the menu, and has to 
  608.         have a menu level of 50 to see it.  The "return" field was used in 
  609.         this example.  Since "N"'s were placed in the "return" field the user 
  610.         will not be prompted to "PRESS RETURN" after the selections.
  611.         -----------------------------------------------------------------------
  612.                 In this example the menu allows the user to see game-oriented 
  613.         text files, and play an online game.
  614.  
  615.         MENU AGE_15
  616.         Selection: 
  617.         5
  618.         1 t C:\BBS\SEE\TODAY.NEW
  619.         2 t C:\BBS\SEE\YESTER.NEW
  620.         3 t C:\BBS\SEE\SCORES.TXT
  621.         @ o C:\BBS\SEE\SEE.TTP FOREM
  622.         Q Exit
  623.         {1}Space Empire Elite
  624.         [================]
  625.  
  626.         [1] Todays News
  627.         [2] Yesterdays news
  628.         [3] Players scores
  629.         [Q] Quit
  630.  
  631.         (Press RETURN to play Space Empire)
  632.  
  633.                 In the above example the '@' character is used to play the game.  
  634.         Remember the '@' character is the same as "RETURN" while using menus.
  635.  
  636.         - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  637.         Last minute update/note
  638.         [---------------------]
  639.                 There is now another way to handle Online Games from within menus.
  640.         This new method allows you to set up your online games almost anyway you
  641.         want.
  642.                 With Transcendence you can have up to 99 different ONLINExx.DAT
  643.         files on your hard drive.  To use this feature create an ONLINExx.DAT file
  644.         that you are not currently using (Lets say ONLINE2.DAT).  From the menu
  645.         processor you can load that ONLINE2.DAT file, and make it run that game.
  646.         Since you can place more information about the game in an ONLINExx.DAT
  647.         file this is more useful than using the one-line command normally used
  648.         by the menu processor.  Here is an example menu:
  649.  
  650.  
  651.         MENU
  652.         Selection: 
  653.         6
  654.         1 t G:\TRANS\MODULES\wrestle\TODAY.txt
  655.         2 t G:\TRANS\MODULES\wrestle\YESNEWS.TXT
  656.         3 t G:\TRANS\MODULES\wrestle\CHAMP.TXT
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.         4 t G:\TRANS\MODULES\wrestle\SCORE.TXT
  666.         5 o 1 
  667.         DEFAULT exit
  668.         {1}FoReM Federation Westling!
  669.            [][][][][][][][][][][][][]
  670.  
  671.         [1] Todays news
  672.         [2] Yesterdays news
  673.         [3] Champion
  674.         [4] Scores
  675.         [5] Play Federation Wrestling!
  676.  
  677.                 To use this feature you use "O" as the TYPE, and simply the
  678.         ONLINExx.DAT number.  Thats it.  Pretty simple, huh?
  679.  
  680.         Another last minute thing:
  681.         []======================[]
  682.  
  683.              You can now place an access level after each "type" field,
  684.         for example you could use "p10" -- The user would have to have an
  685.         access level of 10 or higher to use that option.
  686.  
  687.  
  688.         BBS PROCEDURES
  689.  
  690.         These are the built in routines that Transcendence recognizes. The names
  691.         as they should appear are followed by the page number that they are
  692.         allowed on.
  693.  
  694.         Page 1 - Main Menu
  695.         Page 2 - File Areas
  696.         Page 3 - Message Bases
  697.         *      - All Areas
  698.  
  699.         Command       Area  Comments
  700.         ------------- ----  ------------------------------------------------------
  701.         ARCUTILS        2   This will allow the user access to the Arc Utilities 
  702.                             Section.
  703.  
  704.         BASEINFO        3   This will allow the user to obtain information about                                         
  705.                             the message base. It includes, Base's Name, number of
  706.                             messages, High Message read by user, etc.
  707.  
  708.         BTCHSEND        2   This allows the user to download files that were 
  709.                             marked fo batch download.
  710.  
  711.         CALLSYS         *   Allows user to Page the Sysop
  712.  
  713.         CATALOG         2   This allows the user to do a Catalog listing of files.
  714.  
  715.         CHECKM          3   This allows the user to check for messages, To, From 
  716.                             them or both.
  717.  
  718.         DOWNLOAD        2   This allows the user to download files.
  719.  
  720.         EMAIL           *   This allows the user to enter the E-mail section and 
  721.                             post E-mail.
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.         ENTERMSG        3   This allows the user to enter/post a message.
  732.  
  733.         EXITFILS        2   This allows the user to Exit the File Areas.
  734.  
  735.         EXITMSG         3   This allows the user to Exit the Message Bases.
  736.  
  737.         FEEDBACK        *   This allows the user to send feedback to the Sysop
  738.  
  739.         FILES           1   This allows the user to enter the File Areas.
  740.  
  741.         FILOCATE        2   This allows the user to Locate a File which searches 
  742.                             all files areas available to him/her for a particular
  743.                             file.
  744.  
  745.         FSYSOP          2   Used to enter Sysop's File Maintainence section.
  746.  
  747.         GOODBYE         *   Allows the user to logoff.
  748.  
  749.         JUMPBASE        1   Allows the user to jump to a different base. The 
  750.                             difference between this command and OTHERMSG is that
  751.                             it will only ask the user for the message base number
  752.                             and not display the list of available message bases.
  753.  
  754.         LISTING         2   Allows the user to obtain a listing (long) of files 
  755.                             available.
  756.  
  757.  
  758.         MACROS          *   Allows the user to define macros.
  759.  
  760.         MARKBASE        *   Allows the user to mark the bases that he wishes to be 
  761.                             scanned when scanning for ne messages, etc. He/she
  762.                             will not be able to mark the bases that are not
  763.                             available to him/her.
  764.  
  765.         MARKFILE        2   Same as MARKBASE except for the File Areas.
  766.  
  767.         MARKREAD        3   Hmmm...
  768.  
  769.         MESBASE         1   Allows the user to Enter the message bases.
  770.  
  771.         MKDESC          2   Replaced with FSYSOP.
  772.  
  773.         MTOPIC          3   Allows the user to view the Topic Description fo a 
  774.                             message bases if you have one defined.
  775.  
  776.         NEWFILES        2   Allows the user to search for New Files.
  777.  
  778.         NEW_MSG         3   Allows the user to search for New Messages.
  779.  
  780.         NEXTBASE        3   Allows the user to go to the Next Available message 
  781.                             bases without being shown the list of available
  782.                             message bases or be asked which base to go to.
  783.  
  784.         NEXTSIG         2   Same as NEXTBASE except for the file areas.
  785.  
  786.         ONLINE          *   Allows the user to enter the Online Games menu. Play 
  787.                             Games!!
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.         OTHERBBS        *   Allows the user to view/enter the Other BBSes list.
  798.  
  799.         OTHERMSG        3   Allows the user to Choose another message base to go 
  800.                             to and will display the list of available Bases.
  801.  
  802.         OTHERS          2   Same as OTHERMSG except for File Areas.
  803.  
  804.         PARMEDIT        *   Allows the user to edit his/her parameters.
  805.  
  806.         PREVBASE        3   Allows the user to go to the Previous Messages base.
  807.  
  808.         Q_SCAN          1   Allows the user to Quick Scan the message bases.
  809.  
  810.         READBACK        3   Allows the user to read messages backwards.
  811.  
  812.         READFILE        2   Allows the user to read a text file online.
  813.  
  814.         READFORW        3   Allows the user to read messages foward.
  815.  
  816.         READMSG#        3   Allows the user to read a certain message number.
  817.  
  818.         RINGBACK        *   Allows the user to choose the Ringback feature. The 
  819.                             BBS will hang up the user and then call him/her back.
  820.  
  821.         SCANEDIT        *   Allows the user to define which file areas to scan for 
  822.                             new files, etc.
  823.  
  824.         SEARCH          2   Allows the user to search the contents of a file's 
  825.                             description, uploader or filename for a particular
  826.                             string of characters.
  827.  
  828.         SEARCHM         3   Same as above except for messages.
  829.  
  830.         SECRTARY        *   Same as CALLSYS except the BBS ask for a reason you 
  831.                             are paging the sysop.
  832.  
  833.         SETHIGH         3   Allows the user to set his/her high message read 
  834.                             counter.
  835.  
  836.         SETTINGS        *   Allows the user to change their definable settings.
  837.  
  838.         SINCEDTE        2   Allows the user to search for files that were uploaded 
  839.                             past a certain date.
  840.  
  841.         SURVEY          *   Allows the user to take a survey.
  842.  
  843.         SYSOP           *   Used to enter Sysop Mode.
  844.  
  845.         TERMINAL        *   Allows the user to select a different Terminal 
  846.                             emulation.
  847.  
  848.         UEDITOR         *   Used to go to the User Editor.
  849.  
  850.         UPLOAD          2   Allows the user to upload a file.
  851.  
  852.         USERLIST        *   Allows the user to obtain a user listing.
  853.  
  854.         USERMES         *   Allows the user to leave a message for the next 
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                             callers.
  864.  
  865.         VIEWCALL        *   Allows the user to view the last xx callers to the 
  866.                             BBS.
  867.  
  868.         VIEWMARK        2   Allows the user to view the files that he/she has 
  869.                             marked for batch download.
  870.  
  871.  
  872.  
  873.         VARIABLE TAGS
  874.  
  875.              Place the variable tags in braces ( '{' and '}' ).  You can
  876.         use variable tags in any of your text files, or prompt files.  An
  877.         example would be "Hello, {2}, how are you?" -- The BBS would
  878.         change {2} into the current users handle.
  879.  
  880.         TAG #     Description
  881.         []=============================================================[]
  882.           1       Clear Screen
  883.           2       User Handle
  884.           3       REAL Name
  885.           4       Password
  886.           5       Address
  887.           6       City
  888.           7       Zip  Code
  889.           8       Phone  #
  890.           9       CPU
  891.           10      Age
  892.           11      Country
  893.           12      Birthday
  894.           13      Number of messsages entered by user
  895.           14      User's video width
  896.           15      User's video length
  897.           16      Emails Sent
  898.           17      User Number
  899.           18      Downloads
  900.           19      Uploads
  901.           20      DL:UL  Ratio
  902.           21      Time Limit Per Day
  903.           22      Time Limit Per Call
  904.           23      Time Used Today
  905.           24      Last Date Called
  906.           25      First Date Call
  907.           26      User's number Of Calls
  908.           27      Today's Date   01/01/92
  909.           28      Today's Date   Jan. 1, 1992
  910.           29      User's Command Table Level
  911.           30      Number of System Calls
  912.           31      Last Caller
  913.           32      Calls Today
  914.           33      Current baud
  915.           34      Current Time
  916.           35      User's Time Left
  917.           36      User's Connect Time
  918.           37      Military Time
  919.           38      Prompt for MORE
  920.           39      Sysop Name
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.           40      BBS Version #
  930.           41      BBS Name
  931.           42      BBS Node #
  932.           43      Chat mode Status
  933.           44      Emails to you
  934.           45      File Area Level
  935.           46      Sex
  936.           47      Press [Return]
  937.           48      Press [Space]
  938.           49      User's Daily Call Limit
  939.           50      30
  940.           51      User's Downloads per call
  941.           52      User's Uploads per call
  942.           53      User's Downloads per day
  943.           54      User's Uploads per day
  944.           55      User's Downloads today
  945.           56      User's Uploads today
  946.           57      User's Command Table Level
  947.           58      User's State
  948.           59      Number of users allocated in userlog
  949.           60      Number of user slots in use in userlog
  950.           61      Number of new users
  951.           62      Number of surveys taken (User)
  952.           63      Number of Fmails sent (User)
  953.           64      Number of Fmsgs Sent (User)
  954.           65      Number of games played (User)
  955.           66      Number of feedbacks (User)
  956.           77      Number of messages entered (User)
  957.           78      Number of Emails Sent (User)
  958.           79      Number of uploads (System)
  959.           80      Number of downloads (System)
  960.           81      User's Status (Alert or Normal)
  961.           82      User's max number of emails per day
  962.           83      User's max number of messages per day
  963.           84      User's max number of feedbacks per day
  964.           85      User's max number of pages per day
  965.           86      User's Online Game Level
  966.           87      User's Menu Processor level
  967.           88      User's download points
  968.           89      User's number of illegal hangups
  969.           90      User's last date they listed new files
  970.           91      System's Use Only
  971.           92      "               "
  972.           93      "               "
  973.           94      "               "
  974.           95      Number of Email Messages Waiting for User 
  975.           96      Temporary holder (System's use only)
  976.           97      User's second phone number
  977.         '
  978.         ' ----- Message Base Variable Tags
  979.         '
  980.           201     Message Number
  981.           202     Lines in Current Message
  982.           203     Message Base name
  983.           204     From
  984.           205     To
  985.           206     Date
  986.           207     Time
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.           208     Subject
  996.           209     Replies
  997.           210     Status
  998.           211     New Messages
  999.           212     High message number
  1000.           213     Max number of messages allowed in base before rollover occurs
  1001.           214     Max number of lines allowed in message before it's extended
  1002.         '
  1003.         ' ------ File Section variable Tags
  1004.         '
  1005.           300     File Area #
  1006.           301     File Area Name
  1007.           302     Number of Files Marked for Batch DL
  1008.           303     File name
  1009.           304     File size
  1010.           305     File Type
  1011.           306     Uploader
  1012.           307     Upload Time
  1013.           308     Upload Date
  1014.           309     Last Downloaded Date
  1015.           310     Number of Downloads
  1016.           311     File Level
  1017.           312     File Status
  1018.           313     CPU Type
  1019.           314     Monitor Type
  1020.           315     File Description
  1021.           316     Approx. Time to Download at {33} (Baud)
  1022.           317     Used for Blank Space
  1023.           318     Default Protocol
  1024.           319     Current Protocol used
  1025.           320     Number of Descriptions/Files
  1026.           321     Approx. Time to Download Marked Files
  1027.           322     File Number
  1028.           323     Not used at Moment
  1029.           324     Xmodem Blocks
  1030.           325     Y/Zmodem Blocks
  1031.           326     Fmodem Blocks
  1032.  
  1033.                 **** These are for System's Use Only
  1034.  
  1035.           327     CPS Rating         
  1036.           328     Old Filename. Used during file renames
  1037.           329     New Filename. "               "
  1038.           330     Max number of allowed uploads
  1039.           331     Max Upload size. Most available Space on Drive.
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.